语法：

steam_ugc_request_item_details(published_file_id, max_age_seconds);

Returns: Async ID

描述

This function can be used to retrieve information about a given file ID. You give the file ID and supply a maximum age for checking (see the Steam docs for more information), then the function returns a unique async ID value which can be used to check the details correctly in the Steam Async event. This event will have the async_load DS map which will be populated with the following key/value pairs:

1. "id" - 触发事件的函数返回的异步 ID
2. 
   
3. "result" - 操作的结果（实际值）。这将是 GML 常量 ugc_result_success 或其他一些实数。So you should check for this constant to ensure that the call was successful, and if otherwise somthing has not worked correctly. 返回的其余可能值显示为 Steam “EResult” 值的结果，你应该在 SDK 头文件 steamclientpublic.h 中看到所有 89 个可能值。
4. 
   
5. "event_type" - The string "ugc_item_details"
6. 
   
7. "cached_data" - Will be true if the returned details are from the local cache or false if they are taken from the server
8. 
   
9. "published_file_id"" -Holds the unique published file id for the item
10. 
    
11. "file_type" - The type of file used
12. 
    
13. "creator_app_id" - The Steam ID of the item creator
14. 
    
15. "consumer_app_id" - The Steam ID of the item consumer
16. 
    
17. "title" - The title of the item
18. 
    
19. "description" - The description of the item
20. 
    
21. "steam_id_owner" - The Steam ID of the item owner
22. 
    
23. "time_created" - The time the item was first created
24. 
    
25. "time_updated" - The last time the item was updated
26. 
    
27. "time_added_to_user_list" - The time that the item was subscribed to
28. 
    
29. "visibility" - The visibility of the item (see steam_ugc_set_item_visibility() for the returned constants)
30. 
    
31. "banned" - Whether the item has been banned (true) or not (false)
32. 
    
33. "accepted_for_use" - Whether the item has been accepted for use (true) or not (false)
34. 
    
35. "tags_truncated" - Short version of the tags as an array
36. 
    
37. "tags" - An array of the tags for the item
38. 
    
39. "handle_file" - The unique file handle for the item
40. 
    
41. "handle_preview_file" - The unique handle for the image preview for the item (can be used as an argument with steam_ugc_download() to download a preview image)
42. 
    
43. "filename" - The name of the item file
44. 
    
45. "file_size" - The size of the item file
46. 
    
47. "preview_file_size" - The size of the preview image
48. 
    
49. "url" - The full URL for the item
50. 
    
51. "votes_up" - The number of up-votes received
52. 
    
53. "votes_down" - The number of down-votes received
54. 
    
55. "score" - The overall score of the item
56. 
    
57. "account_id_owner" - The account ID from the Steam ID owner (this can be used in the function steam_ugc_create_query_user_ex())
58. 
    

Extended 举例：

In this example we send off a details request for an item and then parse the resulting async_load DS map to set some variables. First we send of the request:

steam_details = steam_ugc_request_item_details(global.fileID, 60);

The above code will request details on the item with the file ID stored in the global variable and will trigger a Steam Async event with the returned information. In this event we can then parse the map and store some of the values in variables which can then be used to display the information to the user:

var map_id = async_load[?"id"];
var result = async_load[?"result"];
if (map_id == steam_details) && (result == ugc_result_success)
   {
   mTitle = async_load[?"title"];
   mDesc = async_load[?"description"];
   mTags = async_load[?"tags"];
   m_hPreviewFile = async_load[?"handle_preview_file"];
   m_hOwnerSteamId = async_load[?"steam_id_owner"];
   mOwnerAccountId = async_load[?"account_id_owner"];
   mPubFileId = async_load[?"published_file_id"];
   mScore = async_load[?"score"];
   }